How to make data files available
HxGN Smart Sites allows you to inspect all kinds of geospatial data. However, you must make this data available to HxGN Smart Sites and configure it to be served to users. This article explains how to do make the data available.
Making data available via LuciadFusion Studio
LuciadFusion Studio allows administrators to upload files via its web interface. Uploaded files are automatically added to a location in its local file system (Windows and container) which is already part of a pre-configured data root.
This is an easy way to upload smaller datasets. However, upload via the web interface does not support features such as resuming in case the upload was interrupted. Each upload is also independent of previous uploads, so it is impossible to replace or update data using this method.
Making data available via the SFTP server
If HxGN Smart Sites is deployed using docker, the deployment includes an SFTP server. This can be used to upload data to both the LuciadFusion and File Server data volumes, from which the data is then accessible to both services.
The connection URL for the SFTP server will depend on your deployment,
but is typically something like sftp://$HSS_ADMIN_HOSTNAME:2222/.
To connect to the SFTP server, use an SFTP client such as Cyberduck (macOS or Windows), WinSCP (Windows), FileZilla (macOS, Windows, Linux), or command line apps such as sftp or curl (macOS, Linux).
FileZilla has issues with SSH public-key authentication.
If the server complains about too many authentication attempts, tell FileZilla to ignore the SSH agent by
setting the environment variable SSH_AUTH_SOCK to null in its environment.
LuciadFusion
To access the data volume of the LuciadFusion container, connect with the user fusion-server.
In this user's home directory, you will see a subdirectory named fusion-server-data.
Within this subdirectory, you have full control of the files and further subdirectories.
The fusion-server account has the same user and group ID as the user that runs the LuciadFusion service,
so any uploaded files and directories are readable by the service.
The fusion-server-data directory that you see via the SFTP server corresponds to the directory /var/lib/app/user
in the container running LuciadFusion. Add a data root on this directory in LuciadFusion to make the data available.
File Server
To access the data volume of the File Server container, connect with the user file-server.
In this user's home directory, you will see a subdirectory named file-server-data.
Within this subdirectory, you have full control of the files and further subdirectories.
The file-server account has the same user and group ID as the user that runs the File Server service,
so any uploaded files and directories are readable by the service.
The file-server-data directory that you see via the SFTP server corresponds to the directory /static
in the container running the File Server. The file system subtree in this directory is made available at
https://$HSS_HOSTNAME/files.